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An Oracle/ Job Queue Facility Primer 


By Suresh Aiyer 


he Oracle7 job queue facility allows a programmer to designate that a pro- 
gram be executed at a specified date and time. The program can be any 
PL/SQL routine or stored procedure. Packages supplied by Oracle can also be 


scheduled for periodic execution. 


Although the Oracle7 job queue facility is part 
of the standard Oracle7 product, it’s not used 
frequently. In this article, we'll discuss how to 
use the job queue facility to schedule periodic 
execution of jobs, and in doing so, look at 
some practical, working examples. Along the 
way, we'll also discuss the use and syntax of the 
CHANGE, BROKEN, RUN, and REMOVE 
procedures; monitoring information in the job 
queue; and look at the role played by Oracle 
packages with this handy functionality. 


As we cover these topics, you'll see that the 
Oracle7 job queue facility provides an alter- 
native to schedulers provided by operating 
systems, and that a good understanding of 
this mechanism can be very helpful in man- 
aging all your databases. 


Wanted: Background Processes 

The Oracle7 job queue facility needs at 
least one of the background processes to 
execute jobs. Known as the SVP back- 
ground processes, they periodically wake up 
and execute any queued jobs that are 
scheduled to run. An Oracle7 instance can 
have a maximum of 10 SNP processes 


named SNPO to SNP9. 


The number of SNP background processes 
for an Oracle7 instance is specified by the 


variable jobnumber number; 
BEGIN 
DBMS_JOB.SUBMIT(:jobnumber, 
‘doms_utility.analyze schema(' ‘schemai' |, 
~ SEGOMPUGE = * jes 5 
SYSDATE,SYSDATE + 1'); 
END; 


Figure 1: Submitting the ANALYZE.SCHEMA job for daily execution. 


JOB_QUEUE_PROCESSES parameter of 
the instance’s initialization parameter file. Set 
this parameter to the number of SNP back- 
ground processes that are needed for the 
Oracle7 instance. 


The JOB_QUEUE_INTERVAL parameter 
specifies the sleep time for the background 
processes. For example, a value of 30 for 
this parameter would result in background 
processes awakening every 30 seconds and 
executing any scheduled jobs. Note that 
the failure of a background process does 
not cause the Oracle7 instance to fail — 
Oracle7 simply restarts the process. 


Juggling Jobs 

Oracle7 supplies a package called 
DBMS_JOB that is used for managing the 
job queue facility. DBMS_JOB contains 
SUBMIT, a procedure you can use for sub- 


mitting a new job to the job queue. 


The example in Figure 1 — which can be 
run from the Server Manager SQL worksheet 
— submits the ANALYZE.SCHEMA job for 
daily execution. The variable, jobnumber, is 
declared to provide an output parameter to 


SUBMIT. 


When a job is submitted, Oracle7 returns a 
job number that is automatically generated. 
This value can be found in the jobnumber 
variable. 


You can also schedule a job to execute once 
or periodically at a set interval. For example, 
the code for the job in Figure 2 executes a 
stored procedure every Friday at 5 PM. 
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DBMS_JOB.SUBMIT(:jobnumber, 


‘'myproc(' ‘proc _parameter' ‘); ', 
SYSDATE, 

'NEXT_DATE(TRUNC(SYSDATE), ' ‘friday’ ') 
+ 17/24') ; 


Figure 2: Using the SUBMIT procedure from the DBMS_JOB pack- 
age, this job will execute the indicated stored procedure at the end 
of each Friday workday. 


After a job has been submitted, it sits in the job queue. 
When the job is scheduled to run, the SNP background 
processes it. To execute a job, the background process creates 
a session and runs the jobs in the same environment where 
the user submitted the job. 


Change It, Break It, Run It, and/or Remove It 
CHANGE, BROKEN, RUN, and REMOVE are important 
procedures that can help you manipulate the jobs submitted 
to the queue. Like SUBMIT, these procedures are in the 
DBMS_JOB package. 


Here’s a summary of their functionality: 

m CHANGE. This procedure allows you to modify the job’s 
procedure and execution time. Here is the procedure’s 
specification: 


PROCEDURE change 
(job IN BINARY_INTEGER, 
what IN VARCHAR2, 
next_date IN DATE, 
interval IN VARCHAR2) ; 


m BROKEN. To set a job as “broken” use the BROKEN pro- 
cedure. A broken job sits in the job queue but Oracle7 
does not execute it. You can set the job as broken if you 
want Oracle7 to temporarily delay the execution of a job. 
For example, BROKEN is very useful when you want to 
fix a job that ran unsuccessfully. Oracle7 also sets a job as 
broken if it fails to successfully execute it after 16 attempts. 


A broken job can be reset as a normal job by using the BRO- 
KEN procedure. In the following example, job 10 is marked 
as not broken and will execute on the subsequent Friday: 


DBMS _JOB.BROKEN(10, FALSE, NEXT DATE(SYSDATE, 'Friday')); 


m RUN. You can force a job to run manually at any time by 
using the RUN procedure. For example: 


DBMS_JOB.RUN(10) ; 


If a job marked as broken is forced to run immediately and 
runs successfully, the job is marked as not broken. (The 
DBMS_JOB package is handy when you have fixed a 


problem with a broken job and want to test it immediately.) 


m REMOVE. Use the REMOVE procedure to remove a job 
from the job queue facility. It takes the form: 


PROCEDURE REMOVE (job IN BINARY_INTEGER) ; 


Monitoring Job Queue Information 

Jobs in the job queue facility can be listed by querying the 
data dictionary tables, USER_JOBS and DBA_JOBS. The 
information about jobs that are currently running can be 
viewed in the data dictionary table, DBA_JOBS_RUNNING. 
If there is a high number of queued jobs in an Oracle7 
instance, then you can add more background processes to 
improve the performance. 


Using the Job Queue Facility 

The Oracle7 job queue facility can be compared to schedul- 
ing facilities found in operating systems (e.g. cron in UNIX). 
Many of the jobs that are run in batch mode under operating 
system schedulers can be run under the job queue facility. 


The job queue facility offers several advantages over operating 
system schedulers. Since the jobs are run within the database, 
they are easier to manage because database monitoring tools 
can be used to oversee them. Also, the jobs can be disabled 
and enabled at any time by setting them as broken without 
removing them from the job queue. Many operating system 
schedulers do not allow this. 


Some jobs in batch mode may require database passwords. If 
these jobs are run under operating system schedulers, pass- 
words are usually stored in scripts or operating system hidden 
files. This can make the passwords more accessible than you 
might like. The job queue facility offers more security because 
jobs running under it don't require database passwords (pro- 
vided they are not accessing data from another database). 


With Oracle release 7.1 and later, Oracle refreshes all snap- 
shots using refresh groups that automatically use the job 
queue mechanism. The job queue facility can be very handy 
in a distributed processing environment. 


For example, when a snapshot is refreshed from a remote 
database in Oracle 7.1.6, the existing data in a snapshot is 
lost if the remote database is unavailable. You can overcome 
this drawback by executing a PL/SQL routine in the job 
queue facility. This will refresh the snapshot only if the con- 
nection to the remote database is successful. The replication 
facility in Oracle7 also uses the job queue facility extensively 
to send data between multiple database sites. 


Conclusion 

Use the Oracle7 job queue facility for periodic execution of 
Oracle routines. Snapshots can be managed more effectively 
by refreshing them with the job queue facility. Since many 
jobs run in batch mode, the job queue facility provides a bet- 
ter and more secure alternative to operating system schedulers. 


The Oracle7 job queue facility can also be very useful for dis- 
tributed database management and symmetric replication. 
Use it to your advantage. Cal 


Suresh Aiyer is a database administrator at Citicorp, in Reston, VA. i 
You can reach him at (703) 560-7005. 0 a 
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